SftTree/OCX 7.0

SftTree.RowHeaderLines Property

Softel vdm, Inc.

Defines the number of row header text lines used for height calculation.

Deprecated - Provided for compatibility with earlier versions only - Use RowHeaders.Lines instead

Syntax       

Get

VB.NET

Lines = object.RowHeaderLines  As Short

VB

Lines = object.RowHeaderLines  As Integer

C#.NET

short Lines = object.RowHeaderLines;

VC++

short Lines = object->RowHeaderLines;
short Lines = object->GetRowHeaderLines();

C

HRESULT object->get_RowHeaderLines(short* Lines);

Delphi

Lines := object.RowHeaderLines   : Smallint;

Put

VB.NET

object.RowHeaderLines = Lines  As Short

VB

object.RowHeaderLines = Lines  As Integer

C#.NET

short object.RowHeaderLines = Lines;

VC++

short object->RowHeaderLines = Lines;
void object->PutRowHeaderLines(short Lines);

C

HRESULT object->put_RowHeaderLines(short Lines);

Delphi

object.RowHeaderLines := Lines   : Smallint;

object

A SftTree object.

Lines

Defines the number of row header text lines used for height calculation.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use RowHeaders.Lines instead

The RowHeaderLines property defines the number of row header text lines used for height calculation.

If fixed height items are used (see Items.Style), all items in a tree control have the same height.  The best height for items is automatically calculated based on the font, graphics and text components used.  If multi-line text entries are desired for row headers, the RowHeaderLines property should be used to set the expected (maximum) number of lines per item.  This insures that multiple lines of text will fit within the vertical space allocated to each item.  Some properties which override default properties are not taken into consideration when calculating the item height. E.g., the Cell.Font property does not affect the item height.  It must be chosen to be smaller or equal to the size of the Font property, otherwise text may be clipped vertically.

If variable height items are used (see Items.Style), items in a tree control can have varying heights.  The best height for each item is automatically calculated based on the font, graphics and text components used.  If multi-line text entries are desired for row headers, the RowHeaderLines property should be used to set the maximum number of lines to be displayed.  This insures that multiple lines of text will fit within the vertical space allocated to each item.  If a row header has more text lines than defined using the RowHeaderLines property, the lines are not visible.  All properties of an item, including cell properties such as the Cell.Font and Cell.Image properties, also affect the item height.

Row headers support multi-line text using new-line characters (CR-LF).  Word-wrap is not supported.

If fixed height items are used (see Items.Style), a tree control defaults to one text line.  If multi-line text is added and the text exceeds the number of lines defined using the RowHeaderLines property, the text will be truncated vertically.

If variable height items are used (see Items.Style), a tree control defaults to one text line.  If more text lines need to be displayed than are defined using the RowHeaderLines property, only the specified number of text lines are displayed followed by a '+', indicating that text lines have been truncated.

See Also  SftTree Object | Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com